Définition des calques et des propriétés (version Production uniquement)

Pour définir un calque dans un script, entrez son nom tel qu'il apparaît dans la fenêtre Montage. Les noms contenant un espace doivent apparaître entre guillemets. A titre d'exemple, dans le script, le nom du calque Bateau rouge doit s'écrire "Bateau rouge".

Pour les fonctions qui requièrent une propriété, vous pouvez spécifier le nom des propriétés suivantes : contour progressif, point d'ancrage, position, échelle, rotation et opacité. Lorsque vous spécifiez une propriété dont le nom est formé par deux mots, tel que point d'ancrage, vous devez l'entourer de guillemets. A titre d'exemple :

value (cercle, "point d'ancrage") = value (carré, "point d'ancrage") * 1,5;

Pour spécifier les propriétés d'un effet, vous pouvez soit utiliser la fonction pop_property, soit la fonction effect_value. La fonction pop_property obtient la valeur de la propriété actuellement sélectionnée dans le menu Propriété spécifié. Après la sélection d'un calque et le chargement d'un script dans Equations, les deux menus des propriétés affichent tous les effets du calque sélectionné. Pour de plus amples informations sur la fonction pop_property , reportez-vous à Utilisation des menus Calques, Propriétés et Couches (version Production uniquement).

La fonction effect_value obtient une valeur de la propriété d'un effet ou crée une image clé pour la propriété d'un effet, selon la position de la fonction dans l'affectation. La fonction effect_value présente la syntaxe suivante :

effect_value (calque, index de l'effet, index de la propriété)

L'index de l'effet et l'index de la propriété sont des nombres qui définissent une propriété dans la fenêtre Effets. La première valeur de l'index de l'effet est 0, celle de l'index de la propriété est 1. Pour définir une propriété dans la fenêtre Effets, vous devez utiliser les index de l'effet et de la propriété ensemble pour identifier l'ordre de la propriété dans la fenêtre. Dans l'exemple suivant, la fenêtre Effets montre trois effets pour le calque Solide1.

A titre d'exemple, pour spécifier la propriété Intensité de l'effet Flou accéléré, la syntaxe de la fonction effect_value doit être la suivante :

effect_value (Solide1, 1, 0)

Dans la fenêtre Effets, l'effet Flou accéléré est le deuxième effet en partant du haut et Intensité est la première (et seule) propriété. Etant donné que la numérotation de l'index de l'effet démarre à 0, le deuxième effet a la valeur 1.

Lorsque la fonction effect_value est utilisée à droite d'une affectation, elle obtient la valeur de la propriété spécifiée. Seules les propriétés ayant des valeurs numériques peuvent générer des valeurs.

Lorsque la fonction effect_value est utilisée à gauche d'une affectation, elle permet de créer une image clé pour la propriété spécifiée. Les valeurs peuvent être attribuées uniquement aux propriétés numériques (telles que les points de contrôle et les angles) et aux propriétés contrôlées par des curseurs dans la fenêtre Effets.

Lorsque vous spécifiez une propriété par l'indexation, toutes les propriétés sont prises en compte indépendamment de leurs types de valeur ou de leurs contrôles.